home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 8: LINUX Games / Linux Cubed Series 8 - LINUX Games.iso / games / x11 / rpg / crossfir.92 / crossfir / crossfire-0.92.5 / INSTALL < prev    next >
Text File  |  1996-07-24  |  10KB  |  212 lines
  1. Directions for installation:
  2.  
  3. Note: Crossfire uses a great deal of floating point, and expects the syntax
  4. to be 'x.y'.  In some environments, the language may be dfferent, so that
  5. the format for floats is 'x,y' or something similar.  If this is the
  6. situation for you, you need to change your environment so that floats are in
  7. the 'x.y' format.
  8.  
  9. 1) You need to meet the following requirements:
  10.   A) 3 to 5 Megabytes of free disk space for object files (note that
  11.   uncompress map files will take a lot more)
  12.   B) A compiler that understands ANSI.
  13.  
  14.   If you don't meet both these requirements, you will be unable to proceed
  15.   further.
  16.  
  17. 2) Edit the config/crosssite.def file.  Most things should be self
  18.    explanatory.  config/master-site.def is an example file of the
  19.    crosssite.def file
  20.    If your local c-compilator doesn't unserstand ANSI-C, then change
  21.    forceCC in config/crosssite.def to an ansi-compilator (for instance
  22.    gcc -ansi).
  23.    All file paths should start with '/'.  Don't use relative filepaths.
  24.    Also, the paths leading up to FONTDIR should be readable.
  25.    When you have customised the crosssite.def file to your local
  26.    system, you can put a copy in the directory which contains the
  27.    crossfire-0.9x.x directories, and it will take precedence over
  28.    the distributed config/crosssite.def.  You should still look over the
  29.    new one, to see if any options have been added, or if the way old options
  30.    are handled has changed.
  31.  
  32. 2a) If you are using a set up that needs the eutl library (Use_Eutl is still
  33.   defined in crossite.def), get and install that package (it should be on the
  34.   same ftp sites as you got crossfire from).  Make sure the path's in the
  35.   crosssite.def file match those that you installed with.
  36.  
  37. 3) Make the makefiles.  This will be required any time the crosssite.def
  38.    file is changed.
  39.    A) cd into the top level (the directory that contains this file.)
  40.    B) type 'xmkmf', or 'xmkmf.ansi' if you have it.  If you lack xmkmf,
  41.       try 'imake -DUseInstalled -I/usr/lib/X11/config'.  If you lack
  42.       imake, there is probably little hope.
  43.  
  44.       If you are running X11R6, you can do 'xmkmf -a'.  This will perform
  45.       actions C and D below, and you can go directly to step 4.
  46.  
  47.    C) type 'make Makefiles'
  48.    D) type 'make depend'  This step is not needed, and you can ignore any
  49.       errors or warnings you get at thi stage.
  50.  
  51. 4) Edit include/config.h.
  52.    Most options should be fairly well commented.  Note that in some cases,
  53.    the options in config.h will not be used, and are instead overridden by
  54.    the options set in the crosssite.def file.
  55.    The default config.h file should have pretty sane values, and need
  56.    little change.
  57.  
  58. 5) Compile the program:
  59.    type 'make'.  It should take a little while.
  60.    If you get errors that abort the compile, copy them down (either using
  61.    cut and paste, or redirect the output of the compile to a file), and
  62.    send those to me (mwedel@pyramid.com), along with what machine type & OS
  63.    you are using.  Also, include the compile line with its various options.
  64.    A message saying 'it failed to compile main.c' tells me little, and I can
  65.    not fix problems with that little detail.
  66.  
  67. 6) Install the program:
  68.    A) make install
  69.    B) make install.man
  70.  
  71.    If you have chosen your destination directory to be the same as
  72.    the directory you are compiling in, try the following commands instead:
  73.    A) cd lib
  74.    B) make install-font
  75.    C) make install-same
  76.  
  77.    The above will create some files and directories that are not supplied
  78.    in the archive, but which crossfire needs to run properly.
  79.  
  80. 7) You may want to set the uid or gid bit on the crossfire executable.
  81.    To do this, type either 'chmod u+s' or 'chmod g+s', with the filename
  82.    being the installed version of crossfire.  The highscore file and
  83.    player directory should have their permissions set appropriately.  This
  84.    is only needed if other people may be running the the executable.
  85.  
  86. 8) If you don't have maps, you will need them.  Grab them off the ftp
  87.    site, and unpack them.  Probably easiest to unpack them into the 
  88.    installed lib directory directory, and save an installation procedure.
  89.    
  90. 9) You can compress/gzip all files in and below the LIBDIR.  Performance of
  91.    compressing various files may very.  Several files are only read during
  92.    startup, so compressing them will not affect game performance once running.
  93.  
  94. 10) It might be useful to edit "lib/motd" (MessageOfToDay) file.
  95.  
  96. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  97. COMMON PROBLEMS:
  98.  
  99. P) When I start the game, the display comes up fine, but the map is filled
  100. with funny characters (demons where buildings should be, etc).
  101.  
  102. S) The font that is being used does not match the archetypes.  This is
  103. typically because an old version of the font is being used.  Make sure the
  104. new font is installed, and that it is the font being used (there may
  105. be several directories in the fontpath.  The font to be used comes
  106. first.)  Otherwise, you can run the program with -pix or, if
  107. it was compiled in, -xpm mode.  This doesn't use the font.
  108.  
  109.  Also, I have noticed (At least with X11R6) that if a program is using
  110. an old version of the font, when another program is run that uses
  111. the same font name, it will also get the old version of the font.
  112. (This typically happens when I have a copy of crossedit running,
  113. and then install a new font, and then run crossfire.  Crossfire uses
  114. the font that crossedit is using.)  This is a bug/feature of X11, and
  115. not crossfires error.
  116.  
  117. If not using fonts, it means that an old version of the crossfire.cfb
  118. or crossfire.pix.? files is being used. Install the new ones (make
  119. install will do the job)
  120.  
  121. ------------------------------------------------------------------------------
  122. P) The server complains that ../lib/unique-items/??? does not exist, and
  123. the game crashes shortly there after.
  124.  
  125. S) Just create the directory.  It should be created by the make install
  126. process, however, if installing by hand, it may be missing.
  127. ------------------------------------------------------------------------------
  128. P) I can't compress/gzip the crossfire.pix files.  If I do, when I
  129. try to run with -xpm, I get errors.
  130.  
  131. S) Two possible problems:
  132.   1) You are using an older version of the XPM library that does not
  133.      support decompressing of the files when loading.  Upgrade a newer
  134.      version of XPM.
  135.   2) In the case of gzip'd files, it is possible that the user that
  136.      the server is running under does not have gzip/gunzip in its
  137.      path.  Add the directory that gzip resides in to that users
  138.      environmental path.  In csh, something like:
  139.  
  140.      setenv PATH ${PATH}:/usr/local/bin
  141.  
  142.      This will add /usr/local/bin (likely place for gzip to be installed)
  143.      to the path.
  144.  
  145. ------------------------------------------------------------------------------
  146. P) It can't find the file stdarg.h, and thus the compile fails.
  147.  
  148. S) If using gcc, stdarg.h should be installed as part of the normal
  149. installation (with fixincludes).  If it is missing, gcc was not installed
  150. correctly.
  151.  
  152. It is also possible that you are using an old version of gcc that does not
  153. have stdarg as part of its include files.  Newer versions have this
  154. file.
  155.  
  156. ------------------------------------------------------------------------------
  157.  
  158. P) I am using Openwindows (or perhaps other windowing system), and
  159. during the compiling of crossedit, it complains about it not being
  160. able to find some header files, like Xaw/Panner.h
  161.  
  162. S) This is a problem in Openwindows 2, in which those header files
  163. are not included (I don't think the library is either).  The only solution
  164. is to upgrade to another windowing system (X11R5, X11R6, or Openwindows
  165. 3).
  166.  
  167. The other solution is just to not compile crossedit.  It is not needed
  168. to play the game, only to edit/create maps.  To do this, you remove
  169. the crossedit entry from the SUBDIRS line, and go back to stage
  170. 3 of the make process (where you make all the Makefiles).
  171.  
  172. ------------------------------------------------------------------------------
  173. P) I can not save characters.
  174.  
  175. S) 
  176. 1) The player save directory was not created.  make install will create
  177. this directory, but if you did not use make install, this could be the
  178. problem.  You can create the directory by hand by doing
  179. 'mkdir LIBDIR/players', where LIBDIR is the library directory
  180. that you set in crosssite.def
  181.  
  182. 2) The save directory's permissions are not set properly for the uid/gid
  183. that crossfire is running under.  Situtation that may have caused
  184. this is that 'mark' installed the program, but 'frank' is running
  185. the program, either at the shell prompt, or because the program
  186. has been chmod u+s with frank's id.
  187.  
  188. ------------------------------------------------------------------------------
  189. P) Other problems with XPM mode:
  190.    A) when displaying to an openwindows system with greyscale, it can not
  191.       create the XPM files (note, just openwindows or greyscale may be the
  192.       problem)
  193.    B) When display xpm mode to another machine (Linux), the images are
  194.       not drawn correctly.
  195.  
  196. S) Both of these problems were seen, and the cause was using an
  197. old XPM library.  If you are having problems of any sort with the XPM
  198. images, please make sure you are using the latest xpm library - this
  199. could be the problem (as of this writing (12/29/94) the newest
  200. version is 3.4c
  201.  
  202. ------------------------------------------------------------------------------
  203. P) When I try to compile, it comlains that it is missing rplay.h
  204.  
  205. S) rplay.h is part of the rplay package.  You either need to install this
  206. package, or comment out the SoundEffects line in the crosssite.h file.
  207. ------------------------------------------------------------------------------
  208. Other problems?  See the section REPORTING BUGS in the README file.  Follow
  209. all instructions there when submitting a bug report.  If you do not, and
  210. provide insufficient information for me to help out, I will likely just mail
  211. you back telling you to follow those instructions.
  212.